====== DokuTranslate Plugin ======

---- plugin ----
description: Plugin for crowdsourced translation of books 
author     : next_ghost 
email      : next_ghost@quick.cz 
type       : action, admin, syntax
lastupdate : 2016-01-22
compatible : Adora Belle, Angua
depends    : 
conflicts  : 
similar    : 
tags       : books, translation

downloadurl: https://github.com/nextghost/dokutranslate/zipball/master
bugtracker : https://github.com/nextghost/dokutranslate/issues
sourcerepo : https://github.com/nextghost/dokutranslate/
donationurl: 

screenshot_img : 
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. Make sure the installed directory is named ''dokutranslate''.

On Angua, you also have to apply the following patch to DokuWiki before installing. Otherwise you risk severe breakage of translated pages. The bug is already fixed in Adora Belle.

<code>diff --git a/inc/cache.php b/inc/cache.php
index ff78e37..e598baa 100644
--- a/inc/cache.php
+++ b/inc/cache.php
@@ -69,7 +69,7 @@ class cache {
 
         if (!empty($this->depends['files'])) {
             foreach ($this->depends['files'] as $file) {
-                if ($this->_time < @filemtime($file)) return false;         // cache older than files it depends on?
+                if ($this->_time <= @filemtime($file)) return false;         // cache older than files it depends on?
             }
         }
 
</code>

===== Usage =====

To use the plugin, you first have to use the admin interface and assign moderator groups to namespaces where you want to translate pages. Moderator group assignment applies to the entire subtree except when overridden by another assignment to subnamespace.

Moderators can then use a checkbox in the edit form to start translation of pages in their assigned namespace. Make sure that the original page contains all the text you want to translate before clicking "Save" because start of translation cannot be reverted.

You can now translate the page one paragraph at a time. Moderators can also write reviews for paragraphs they haven't last edited themselves. These reviews are used to calculate completion status displayed next to links on pages not under translation.

**//DO NOT use external edits on pages under translation. EVER.//**

To get the finished translation, append ''?do=export_xhtmlbody'' to the page URL or use some export plugin.

=== Change Log ===

{{rss>https://github.com/nextghost/dokutranslate/commits/master.atom date}}